通过发起一次充值退款请求创建一个新的 refund 对象,只能对已经充值成功的 recharge 对象发起全额退款。当退款成功后,会发送 Webhooks 通知。
| 请求参数 | 描述 |
|---|---|
| APP_ID required string | 对应 app 对象的 id,该参数仅需要填写在请求地址内,查看 如何获取App ID。 |
| RECHARGE_ID required string | recharge 对象的 id,该参数仅需要填写在请求地址内。 |
| description required string | 退款详情,最多 255 个 Unicode 字符。针对 cmb_wallet & cmb_pc_qr 渠道最多支持 99 字节;针对 jdpay_wap 渠道最多支持 128 字节;针对 paypal 渠道最多支持 30 字节;针对 coolcredit 渠道最多支持 100 Unicode 字符。 |
| funding_source optional string | 微信及 QQ 类退款资金来源。取值范围:unsettled_funds:使用未结算资金退款;recharge_funds:微信-使用可用余额退款,QQ-使用可用现金账户资金退款。注:默认值 unsettled_funds,该参数对于微信渠道的退款来说仅适用于微信老资金流商户使用,包括 wx、wx_pub、wx_pub_qr、wx_lite、wx_wap、wx_pub_scan 六个渠道;新资金流退款资金默认从基本账户中扣除。该参数仅在请求退款,传入该字段时返回。 |
| metadata optional hash | 详见 元数据。 |
返回
返回一个 refund 对象,或者返回一个错误,详见 错误。
POST https://api.pingxx.com/v1/apps/{APP_ID}/recharges/{RECHARGE_ID}/refunds待补充
待补充
待补充
待补充
待补充
待补充
待补充
curl https://api.pingxx.com/v1/apps/app_1Gqj58ynP0mHeX1q/recharges/2001706060000002372/refunds \
-H "Pingplusplus-Signature: {SIGNATURE}" \
-H "Pingplusplus-Request-Timestamp: 1496728534" \
-u sk_test_ibbTe5jLGCi5rzfH4OqPW9KC: \
-d {
"description": "reharge refunds"
}待补充
待补充
待补充
待补充
待补充
待补充
待补充
{
"id": "re_vXr14Se1GOGKyjzj5KPKizv9",
"object": "refund",
"order_no": "20161000167",
"amount": 10000,
"created": 1496743652,
"succeed": false,
"status": "pending",
"time_succeed": null,
"description": "reharge refunds",
"failure_code": null,
"failure_msg": null,
"metadata": {},
"charge": "ch_SejbHOrzbjvPunjHmD08SCi9",
"charge_order_no": "20161000167",
"transaction_no": null,
"extra": {}
}